home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.5 Complementary Applications 2004 February / SGI IRIX 6.5 Complementary Applications 2004 February.iso / dist / cde.idb / usr / dt / share / man / cat3 / XmStringNConcat.z / XmStringNConcat
Encoding:
Text File  |  2003-11-18  |  2.5 KB  |  67 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmSSSSttttrrrriiiinnnnggggNNNNCCCCoooonnnnccccaaaatttt((((3333XXXX))))       UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV       XXXXmmmmSSSSttttrrrriiiinnnnggggNNNNCCCCoooonnnnccccaaaatttt((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       _X_m_S_t_r_i_n_g_N_C_o_n_c_a_t - A compound string function that appends a
  10.       specified number of bytes to a compound string
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.       #include <Xm/Xm.h>
  14.  
  15.       XmString XmStringNConcat (ssss1111,,,,    ssss2222,,,, nnnnuuuummmm____bbbbyyyytttteeeessss)
  16.            _X_m_S_t_r_i_n_g     ssss1111;
  17.            _X_m_S_t_r_i_n_g     ssss2222;
  18.            _i_n_t     nnnnuuuummmm____bbbbyyyytttteeeessss;
  19.  
  20.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  21.       _X_m_S_t_r_i_n_g_N_C_o_n_c_a_t appends a specified number of    bytes from ssss2222
  22.       to the end of    ssss1111, including tags, directional    indicators,
  23.       and separators.  It then returns the resulting compound
  24.       string.  The original    strings    are preserved.    The space for
  25.       the resulting    compound string    is allocated within the
  26.       function.  The application is    responsible for    managing the
  27.       allocated space.  The    memory can be recovered    by calling
  28.       _X_m_S_t_r_i_n_g_F_r_e_e.
  29.  
  30.       ssss1111   Specifies the compound string to    which a    copy of    ssss2222 is
  31.            appended.
  32.  
  33.       ssss2222   Specifies the compound string that is appended to the
  34.            end of ssss1111.
  35.  
  36.       nnnnuuuummmm____bbbbyyyytttteeeessss
  37.            Specifies the number of bytes of    ssss2222 to append to    ssss1111.
  38.            If this value is    less than the length of    ssss2222, as many
  39.            bytes as    possible, but possibly fewer than this value,
  40.            will be appended    to ssss1111 such that    the resulting string
  41.            is still    a valid    compound string.
  42.  
  43.      RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  44.       Returns a new    compound string.
  45.  
  46.      RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN
  47.       _X_m_S_t_r_i_n_g_C_r_e_a_t_e(_3_X) and _X_m_S_t_r_i_n_g_F_r_e_e(_3_X).
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                        (printed 11/11/03)
  64.  
  65.  
  66.  
  67.